<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>软件定时器 - FreeRTOS学习笔记</title>
    <style>
        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }

        body {
            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
            line-height: 1.6;
            color: #333;
            background-color: #f4f4f4;
        }

        header {
            background: linear-gradient(135deg, #2c3e50, #3498db);
            color: white;
            text-align: center;
            padding: 2rem 0;
            box-shadow: 0 2px 5px rgba(0,0,0,0.1);
        }

        h1 {
            font-size: 2.5rem;
            margin-bottom: 0.5rem;
        }

        .subtitle {
            font-size: 1.2rem;
            opacity: 0.9;
        }

        nav {
            background-color: #2c3e50;
            padding: 0;
            position: sticky;
            top: 0;
            z-index: 100;
            box-shadow: 0 2px 5px rgba(0,0,0,0.1);
        }

        nav ul {
            list-style: none;
            display: flex;
            justify-content: center;
            flex-wrap: wrap;
        }

        nav li {
            margin: 0;
        }

        nav a {
            display: block;
            color: white;
            text-decoration: none;
            padding: 1rem 1.5rem;
            transition: background-color 0.3s;
        }

        nav a:hover {
            background-color: #3498db;
        }

        .container {
            max-width: 1200px;
            margin: 2rem auto;
            padding: 0 2rem;
        }

        .content {
            background-color: white;
            border-radius: 8px;
            padding: 2rem;
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
        }

        section {
            margin-bottom: 3rem;
        }

        h2 {
            color: #2c3e50;
            border-bottom: 2px solid #3498db;
            padding-bottom: 0.5rem;
            margin-bottom: 1.5rem;
        }

        h3 {
            color: #3498db;
            margin: 1.5rem 0 1rem;
        }

        h4 {
            color: #2c3e50;
            margin: 1rem 0 0.5rem;
        }

        p {
            margin-bottom: 1rem;
        }

        ul, ol {
            margin-left: 2rem;
            margin-bottom: 1rem;
        }

        li {
            margin-bottom: 0.5rem;
        }

        pre {
            background-color: #f8f9fa;
            border: 1px solid #e9ecef;
            border-radius: 4px;
            padding: 1rem;
            overflow-x: auto;
            margin: 1rem 0;
        }

        code {
            font-family: 'Courier New', monospace;
            background-color: #f8f9fa;
            padding: 0.2rem 0.4rem;
            border-radius: 3px;
            font-size: 0.9rem;
        }

        pre code {
            background-color: transparent;
            padding: 0;
        }

        .function-signature {
            background-color: #e8f4fc;
            border-left: 4px solid #3498db;
            padding: 1rem;
            margin: 1rem 0;
            border-radius: 0 4px 4px 0;
        }

        .footer {
            text-align: center;
            padding: 2rem;
            background-color: #2c3e50;
            color: white;
            margin-top: 2rem;
        }

        .nav-links {
            display: flex;
            justify-content: space-between;
            margin-top: 2rem;
        }

        .nav-links a {
            text-decoration: none;
            color: #3498db;
            font-weight: bold;
            padding: 0.5rem 1rem;
            border: 1px solid #3498db;
            border-radius: 4px;
        }

        .nav-links a:hover {
            background-color: #3498db;
            color: white;
        }

        @media (max-width: 768px) {
            nav ul {
                flex-direction: column;
            }

            .container {
                padding: 0 1rem;
            }

            h1 {
                font-size: 2rem;
            }
        }
    </style>
    <!-- 引入浮动笔记窗口脚本 -->
    <script src="float-notes.js"></script>
</head>
<body>
    <header>
        <h1>FreeRTOS学习笔记</h1>
        <p class="subtitle">第七章：软件定时器</p>
    </header>

    <nav>
        <ul>
            <li><a href="index.html">主页</a></li>
            <li><a href="chapter1.html">基础知识</a></li>
            <li><a href="chapter2.html">任务管理</a></li>
            <li><a href="chapter3.html">任务调度</a></li>
            <li><a href="chapter4.html">内存管理</a></li>
            <li><a href="chapter5.html">队列</a></li>
            <li><a href="chapter6.html">信号量</a></li>
            <li><a href="chapter7.html">软件定时器</a></li>
            <li><a href="image_gallery.html">图片资源</a></li>
        </ul>
    </nav>

    <div class="container">
        <div class="content">
            <section id="timers">
                <h2>7. 软件定时器</h2>
                
                <h3>7.1 定时器类型</h3>
                
                <h4>单次定时器</h4>
                <ul>
                    <li>超时后执行一次回调函数</li>
                    <li>需要手动重新启动才能再次运行</li>
                    <li>适用于延时执行或超时处理</li>
                </ul>
                
                <h4>周期定时器</h4>
                <ul>
                    <li>超时后自动重新启动</li>
                    <li>周期性执行回调函数</li>
                    <li>适用于周期性任务</li>
                </ul>
                
                <h3>7.2 定时器服务任务</h3>
                <p>软件定时器依赖定时器服务任务：</p>
                <ul>
                    <li>管理所有软件定时器</li>
                    <li>处理定时器命令队列</li>
                    <li>调用超时定时器的回调函数</li>
                    <li>优先级应设置得较低，避免影响其他任务</li>
                </ul>
                
                <h3>7.3 定时器使用注意事项</h3>
                <ul>
                    <li>回调函数中不能调用可能导致阻塞的API</li>
                    <li>回调函数应尽快执行完毕</li>
                    <li>定时器精度受系统时钟和调度影响</li>
                </ul>
                
                <h3>7.4 软件定时器相关函数详解</h3>
                
                <h4>xTimerCreate - 创建定时器</h4>
                <div class="function-signature">
                    <pre><code>TimerHandle_t xTimerCreate(
    const char * const pcTimerName,      // 定时器名称
    const TickType_t xTimerPeriodInTicks,// 定时器周期（时钟节拍数）
    const UBaseType_t uxAutoReload,      // 自动重载模式（pdTRUE=周期，pdFALSE=单次）
    void * const pvTimerID,              // 定时器ID
    TimerCallbackFunction_t pxCallbackFunction // 回调函数
);</code></pre>
                </div>
                
                <p><strong>返回值</strong>：</p>
                <ul>
                    <li>成功：定时器句柄</li>
                    <li>失败：NULL</li>
                </ul>
                
                <p><strong>作用</strong>：创建一个软件定时器</p>
                
                <p><strong>示例</strong>：</p>
                <pre><code>// 定时器回调函数
void vTimerCallback(TimerHandle_t xTimer) {
    // 定时器超时处理
    printf("Timer expired!\n");
}

// 创建周期定时器，周期1000个时钟节拍
TimerHandle_t xTimer = xTimerCreate(
    "MyTimer",                    // 定时器名称
    1000,                         // 周期1000个节拍
    pdTRUE,                       // 周期模式
    0,                            // 定时器ID
    vTimerCallback                // 回调函数
);

if (xTimer != NULL) {
    // 定时器创建成功
} else {
    // 定时器创建失败
}</code></pre>
                
                <h4>xTimerStart - 启动定时器</h4>
                <div class="function-signature">
                    <pre><code>BaseType_t xTimerStart(
    TimerHandle_t xTimer,         // 定时器句柄
    TickType_t xTicksToWait       // 阻塞等待时间
);</code></pre>
                </div>
                
                <p><strong>返回值</strong>：</p>
                <ul>
                    <li>pdPASS: 命令发送成功</li>
                    <li>pdFAIL: 命令发送失败</li>
                </ul>
                
                <p><strong>作用</strong>：启动定时器</p>
                
                <p><strong>示例</strong>：</p>
                <pre><code>// 启动定时器，阻塞等待
if (xTimerStart(xTimer, portMAX_DELAY) == pdPASS) {
    // 定时器启动命令发送成功
} else {
    // 定时器启动命令发送失败
}</code></pre>
                
                <h4>xTimerStop - 停止定时器</h4>
                <div class="function-signature">
                    <pre><code>BaseType_t xTimerStop(
    TimerHandle_t xTimer,         // 定时器句柄
    TickType_t xTicksToWait       // 阻塞等待时间
);</code></pre>
                </div>
                
                <p><strong>返回值</strong>：</p>
                <ul>
                    <li>pdPASS: 命令发送成功</li>
                    <li>pdFAIL: 命令发送失败</li>
                </ul>
                
                <p><strong>作用</strong>：停止定时器</p>
                
                <p><strong>示例</strong>：</p>
                <pre><code>// 停止定时器
if (xTimerStop(xTimer, 0) == pdPASS) {
    // 定时器停止命令发送成功
} else {
    // 定时器停止命令发送失败
}</code></pre>
                
                <h4>xTimerChangePeriod - 更改定时器周期</h4>
                <div class="function-signature">
                    <pre><code>BaseType_t xTimerChangePeriod(
    TimerHandle_t xTimer,         // 定时器句柄
    TickType_t xNewPeriod,        // 新的周期
    TickType_t xTicksToWait       // 阻塞等待时间
);</code></pre>
                </div>
                
                <p><strong>返回值</strong>：</p>
                <ul>
                    <li>pdPASS: 命令发送成功</li>
                    <li>pdFAIL: 命令发送失败</li>
                </ul>
                
                <p><strong>作用</strong>：更改定时器的周期</p>
                
                <p><strong>示例</strong>：</p>
                <pre><code>// 更改定时器周期为2000个节拍
if (xTimerChangePeriod(xTimer, 2000, 0) == pdPASS) {
    // 周期更改命令发送成功
} else {
    // 周期更改命令发送失败
}</code></pre>
            </section>
            
            <div class="nav-links">
                <a href="chapter6.html">上一章：信号量</a>
                <a href="index.html">返回首页</a>
            </div>
        </div>
    </div>

    <footer class="footer">
        <p>FreeRTOS学习笔记 &copy; 2025</p>
        <p>作者: zou.commit()</p>
    </footer>
</body>
</html>